home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / upgrador.zip / UPGRADOR.DOC < prev    next >
Text File  |  1992-10-10  |  8KB  |  204 lines
  1.                              U P G R A D O R
  2.                             + + + + + + + + +
  3.  
  4.                 Version 1.01                 Compiled 10/10/92
  5.  
  6. UPGRADOR is designed to be run as a live DOOR program on Wildcat! 3.x systems. 
  7.  
  8. HOW IT WORKS:
  9. =============
  10. UPGRADOR searches the DOS path for its own configuration file (UPGRADOR.CFG)
  11. and takes its operating information from that file.  A sample is enclosed
  12. with this ZIP file and is shown below.  Once UPGRADOR has determined that
  13. the files it needs are available, it reads USERINFO.DAT and DOOR.SYS in the
  14. current directory to find out who's calling.  If the caller's name is found
  15. in UPGRADOR.LST and if the caller enters the upgrade code correctly, then
  16. the security level in USERINFO.DAT is modified to the name in NEWSEC as shown
  17. below.  Upon reloading after UPGRADOR exits, Wildcat! will change the caller's
  18. security level to that new value if it is defined in your system setup. 
  19.  
  20. SAMPLE UPGRADOR.CFG:
  21. ====================
  22.  
  23. LISTPATH=C:\WC30\
  24. TEXTPATH=C:\UPGRADOR\
  25. OLDSEC=NEWUSER, REGULAR
  26. NEWSEC=MEMBER
  27.  
  28. The four lines above are required to operate UPGRADOR.  They should be
  29. edited to contain the following information:
  30.  
  31.         LISTPATH=       This contains the complete drive and pathname of
  32.                         the directory where you will create UPGRADOR.LST.
  33.                         This file is a listing of member names and the
  34.                         upgrade code they're required to enter.  It can
  35.                         be automatically created by WCPRO if desired ...
  36.                         see the DOC file for details.
  37.  
  38.         TEXTPATH=       This contains the complete drive and pathname of
  39.                         the directory which will contain the display files
  40.                         used by UPGRADOR.  Two files are required ...     
  41.                         WELCOME.TXT, and FAILED.TXT.  Examples of each are
  42.                         enclosed in UPGRADOR.ZIP
  43.  
  44.         OLDSEC=         This is the security level of callers who may use
  45.                         this door.  More than one security level may be
  46.                         entered on this line, separated by a comma or a
  47.                         space.
  48.  
  49.         NEWSEC=         This is the security level to which the caller will
  50.                         be raised if the upgrade code is entered correctly.
  51.                         ONLY ONE LEVEL may be entered here.
  52.  
  53.  
  54. -----
  55.  
  56. In the directory defined in LISTPATH, you must place your UPGRADOR.LST file.
  57. This file may be automatically created by WCPRO, or you may do it manually
  58. with a text editor.
  59.  
  60. It must contain the FULL NAME of the person eligible for the upgrade, as 
  61. well as the upgrade code.  NOTE: The upgrade code cannot be contained in
  62. the person's name or it will fail.  The upgrade code also may NOT contain
  63. the "/" character.  This is to allow you to put a date on the same line in
  64. the text file.
  65.  
  66. SAMPLE UPGRADOR.LST:
  67. ====================
  68.  
  69. FRED FINORK             KAYAY           10/10/92
  70. GREGORY GUTIERREZ       OKYNOT          10/02/92
  71.  
  72. -----
  73.  
  74. USING WCPRO TO CREATE UPGRADOR.LST:
  75. ===================================
  76.  
  77. First, edit the user records of the people you intend to upgrade.  I
  78. suggest entering the current date in the MEMO DATE field, and the 
  79. upgrade code in the COMMENT2 field.
  80.  
  81. Set up a WCPRO command file to match ALL users with a MEMO DATE less
  82. than NN days old, and write a report containing USER NAME, COMMENT2,
  83. and MEMO DATE, all output as fixed length records.  Run WCPRO with this
  84. command file whenever you want to add users eligible for upgrade.
  85.  
  86. Of course you may omit the MEMO DATE from the output, but I find it 
  87. convenient for reference purposes.  You'll want to FILL IN the memo
  88. date, though, because you'll need that field to LIMIT the names output
  89. by WCPRO.
  90.  
  91.  
  92. DISPLAY FILES:
  93. ==============
  94.  
  95. In the directory defined in TEXTPATH, you must place your WELCOME.TXT and 
  96. your FAILED.TXT files.  If the caller successfully enters the upgrade code,
  97. the WELCOME.TXT file is displayed.  If not, then the FAILED.TXT file is
  98. shown.
  99.  
  100. SAMPLE WELCOME.TXT:
  101. ===================
  102.  
  103. Now that you have been upgraded to MEMBER level, please take a moment to
  104. write down this telephone number.  It will give you easier access to the
  105. Cabin:
  106.  
  107.                           (213)   656-6955
  108.  
  109. Also, keep your verification letter in a safe place.  If you should ever
  110. need to reconfirm your membership, the upgrade code in the verification
  111. letter may be used to help us locate your original application.
  112.  
  113. Enjoy the board ... and feel free to pass along any comments or suggestions
  114. to help improve our operations.
  115.  
  116. Later on, if you should decide to become a supporting subscriber, information
  117. is available online (Bulletin #17) or by downloading SUBSCRIB.APP.
  118.  
  119. -----
  120.  
  121. SAMPLE FAILED.TXT:
  122. ==================
  123.  
  124. If you feel that you need assistance completing the upgrade procedure, 
  125. please leave a comment to the SysOp and check back in a few hours for
  126. further instructions.
  127.  
  128.  
  129. SETTING UP A DOOR:
  130. ================== 
  131. The Wildcat! manual and other tutorials have done a fine job of explaining
  132. how to set up a door on your BBS.  Therefore I won't re-invent the wheel by
  133. going through all of the directory naming and batch file creating necessary
  134. to execute UPGRADOR.  
  135.  
  136. It's important to note that UPGRADOR will check the CURRENT directory (where
  137. your DOOR program is started) for either DOOR.SYS or CALLINFO.BBS.  Wildcat!
  138. version 3.x creates DOOR.SYS; earlier versions created CALLINFO.BBS.  On my
  139. system, I let UPGRADOR run from the current directory and search the DOS path
  140. to find its configuration file.
  141.  
  142. IMPORTANT!!!
  143. ============
  144. UPGRADOR needs ENVIRONMENT VARIABLES:  These MUST be present for each node 
  145. of your Wildcat! system in order for UPGRADOR to function properly:
  146.  
  147. SET WCPORTID=2     < put these lines in your Wildcat! startup batch file and
  148. SET WCIRQID=3      <   check to be sure they are added to your environment.
  149.  
  150. NOTE that WCNODEID is NOT used by this door ... 
  151.  
  152. If you have a non-standard port address, you'll need to provide an additional
  153. environment variable with the DECIMAL port address:
  154.  
  155. SET COMBASE=1016  << substitute your correct decimal port address here.
  156.  
  157. That will override the default address of the port number specified in 
  158. WCPORTID.   WCIRQID will still need to be set to the correct interrupt
  159. value.  UPGRADOR supports IRQs in the range 2-15.
  160.  
  161. A sample batch file for Wildcat! version 3.x would look something like this:
  162.  
  163. REM this is a sample batch file for UPGRADOR with Wildcat! 3.x
  164. REM this assumes you SHELL to your doors.  If you TERMINATE, you
  165. REM need to add a change-directory back to your startup directory
  166. REM and then run your startup batch file.
  167. ECHO OFF
  168. UPGRADOR
  169. EXIT    
  170.  
  171. Note that UPGRADOR monitors time online and Carrier Detect, and will close
  172. and exit gracefully back to the node if the caller drops offline while in
  173. the door.
  174.  
  175.  
  176.  
  177. ------------------------------------------------------------------
  178. PROBLEMS, SUGGESTIONS:
  179.  
  180. This program is public domain.  I don't seek or accept any donations for 
  181. this  or any of my other Wildcat! utility programs, including TODAYBBS, 
  182. FLOP, MSTAT, USTAT, and others.
  183.  
  184. I welcome suggestions, and will try to help (no guarantees) if there are
  185. problems.
  186.  
  187. You may contact me at The Charlatan's Cabin BBS  (213) 654-7337.  Mention
  188. your Wildcat! registration number in the comment and you'll be upgraded to
  189. visiting sysop level without the usually required registration by mail.
  190.  
  191. You may also leave a message via CompuServe EMail. My CompuServe account 
  192. number is 70250,220.  I also regularly check the Mustang Software head-
  193. quarters BBS, especially the "3rd Party Utilities Help" conference.
  194.  
  195. Please, NO VOICE CALLS.  This isn't meant to be unfriendly, but with the 
  196. price of public domain software these days ... I just can't afford to be 
  197. "on call."  I WILL respond to your questions via my BBS or CompuServe,
  198. or via the Mustang Software registered SysOp BBS.
  199.  
  200. Version history:
  201.  
  202. 1.01     10/10/92       First release of UPGRADOR.
  203.  
  204.